home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 4 / Gold Medal Software - Volume 4 (Gold Medal) (1994).iso / os2 / mdf121.arj / MDF_ENG.DOC < prev    next >
Text File  |  1994-06-12  |  11KB  |  366 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                   MDIFF  -  MPATCH
  14.  
  15.                                     Release  1.21
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.            A simply and complete software to produce and apply patches to
  30.                             your programs and data files.
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                                    English manual.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                   (C) 1994/95 Maurizio Giunti - All rights reserved
  56.  
  57.  
  58.  
  59.  
  60.  
  61.          1.INDEX
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.          1.INDEX ........................................2
  70.  
  71.          2.WHY ? ........................................3
  72.  
  73.          3.WHAT MDIFF-MPATCH DOES ? .....................3
  74.  
  75.          4.DOS AND OS/2 .................................3
  76.  
  77.          5.LIMITS .......................................3
  78.  
  79.          6.MDIFF - MDIFF2 ...............................3
  80.  
  81.          7.MPATCH - MPATCH2 .............................4
  82.  
  83.          8.ADVICES ......................................4
  84.  
  85.          9.RIGHTS .......................................5
  86.  
  87.          10.WARRANTY ....................................5
  88.  
  89.          11. C++ CLASS LIBRARIES ........................5
  90.  
  91.          12.HOW TO REGISTER .............................5
  92.  
  93.          13.ACKNOWLEDGEMENTS ............................6
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                - 2 -
  118.  
  119.  
  120.  
  121.  
  122.  
  123.          2.WHY ?
  124.          Some week ago I had to release a new version of a program written
  125.          by me: the compressed packet was about 200 KBytes,  and I thought
  126.          that it was better to update the old version of  the program with
  127.          a patch.I looked for patch makers/appliers programs but I did not
  128.          find any software  that satisfied  me. Moreover I  did'nt find  a
  129.          software that runs both under Dos and OS/2 2.xx.
  130.          I decided to make my own patch software and.....here it is ! 8-)
  131.  
  132.  
  133.  
  134.          3.WHAT MDIFF-MPATCH DOES ?
  135.  
  136.          MDIFF creates a binary difference between two  files. With MPATCH
  137.          and the older file  you can create the  newer file using  the the
  138.          difference file.  Where  is the  advantage  ? Easy:  usually  the
  139.          difference file is  smaller than newer  file, so it's  convenient
  140.          distribute it, expecially by modem.
  141.  
  142.  
  143.  
  144.          4.DOS AND OS/2
  145.  
  146.          In the distribution  packet you will  find 4 executable  files, 2
  147.          for Dos  and  2  for  OS/2  2.xx. There  are  no  differences  in
  148.          functions and usage of  the different versions.  Difference files
  149.          produced with MDIFF for Dos can be used with MPATCH for OS/2 2.xx
  150.          and vice-versa.
  151.  
  152.  
  153.  
  154.          5.LIMITS
  155.  
  156.          MDIFF can't work on files greater than 16  Mbytes. Moreover MDIFF
  157.          Dos version can't work on files  greater than the amount  of free
  158.          conventional memory of the  system. OS/2 version, thanks  to OS/2
  159.          flat memory model, is not affected by this limitation.
  160.  
  161.  
  162.  
  163.          6.MDIFF - MDIFF2
  164.  
  165.          MDIFF compares 2 files and stores the differences between them in
  166.          a difference file. This is the command line syntax:
  167.  
  168.                 MDIFF [-C<c>] [-R<r>] <OldFile> <NewFile> [<MDFfile>]
  169.  
  170.          <OldFile> is the name of the older file, <NewFile> is the name of
  171.          the newer  file. If  you wish  you can  specify the  name of  the
  172.          difference file  that MDIFF  will produce,  otherwise MDIFF  will
  173.          create a  file with  the name  of  the newer  file  but with  the
  174.          extension ".MDF".
  175.          To search differences between files,  MDIFF use a base  string of
  176.          defined lenght named  Chunk. The  Chunk lenght is  by default  16
  177.  
  178.  
  179.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                - 3 -
  180.  
  181.  
  182.  
  183.  
  184.  
  185.          bytes, but you  can change it,  in the range  4-256, with the  -C
  186.          switch followed by the desired lenght.
  187.          When MDIFF  loses the  synchronism between  the  two files  being
  188.          compared,  it  scans  the   older  file  searching   the  current
  189.          chunk.This scansion  is executed,  by default,  in a  range of  8
  190.          blocks of 512 bytes each. You can change the number of the blocks
  191.          scanned, in the range  1-16, with the  -R switch followed  by the
  192.          desired number of blocks.
  193.          If this  search  fails,  MDIFF  tries  to  force  synchronization
  194.          through a large range  search. This range  is defined as  1/16 of
  195.          the old  file  lenght.  The  second  search can  be  disabled  by
  196.          specifying -F switch on the command line.
  197.          If you  specify -S  switch, MDIFF  will  output some  information
  198.          about the composition of the diff file.
  199.  
  200.  
  201.  
  202.          7.MPATCH - MPATCH2
  203.  
  204.          With the old file and the .MDF file you can rebuild  the new file
  205.          running MPATCH. This is the command line syntax:
  206.  
  207.                       MPATCH <MDFfile> [<OldFile>] [<NewFile>]
  208.  
  209.          MPATCH needs only the name of the mdf file (<MDFfile>) because it
  210.          contains the names  of the other  2 files,  but it's possible  to
  211.          override these names  by simply specifying  the desired names  on
  212.          the command line. MPATCH does not have any switches.
  213.  
  214.  
  215.  
  216.          8.ADVICES
  217.  
  218.          The best method  to build  a difference  file, is  to search  the
  219.          chunks of the newer file in the entire older file, but  this is a
  220.          very slow way to do !
  221.          MDIFF's algorithm tries to give a  small diff file in  the faster
  222.          way; so you  are sometimes required  to tune the  work parameters
  223.          with the command line switches.
  224.          Let's look some tipical situations:
  225.          1. Very similar  files: use  a large  chunk (32,  64 or  more) to
  226.             reduce the size of the diff file.
  227.          2. Text files: try  to use a  chunk size  of 32,  sometimes it is
  228.             better to turn the forced sync off, with the -F switch.
  229.          3. Very large executable: try to use a larger resync range (16 or
  230.             more), with the -R switch.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                - 4 -
  242.  
  243.  
  244.  
  245.  
  246.  
  247.          9.RIGHTS
  248.  
  249.          This software belongs to Shareware programs: anyone can freely
  250.          distribute and use it for a trial period of 15 days. After this
  251.          period, users that continue to use it must register their copy by
  252.          sending the registration fee to the author, Maurizio Giunti.
  253.          Users that get registered will receive a "registration key".
  254.          Anyone can re-distribute this software, but only if he/she asks
  255.          back no money, except for copy and/or shipping expenses (anyway,
  256.          these expenses must be carefully documented). Another condition
  257.          that you must follow to distribute it, is to furnish the ORIGINAL
  258.          packet always, without any modifications to the program and/or
  259.          documentation.
  260.          There  is  an  exception:  you  can   distribute  MPATCH.EXE  (or
  261.          MPATCH2.EXE) with  one  or  more  *.MDF  files  produced  with  a
  262.          REGISTERED copy of MDIFF.
  263.  
  264.  
  265.  
  266.          10.WARRANTY
  267.  
  268.          The only warranty that comes with  this software is that  it will
  269.          occupy disk space. I absolutely can NOT warrant you  that it will
  270.          perfectly work, or that it will be your problems' resolution.
  271.          Nevertheless, I  am sure  that it  is not  a virus  and does  not
  272.          contain (unless  infected  or  modified  after  the  compilation)
  273.          Trojan-horses, backdoors and similar tricky garbage. In any case,
  274.          the author is not responsible for any damage,  moral or material,
  275.          direct or indirect, derived from its usage.
  276.  
  277.  
  278.  
  279.          11. C++ CLASS LIBRARIES
  280.  
  281.          Inside  this  distribution  packet  you  will   find  some  class
  282.          libraries, for Dos and OS/2 2.xx,  to build your own  programs to
  283.          apply patches produced by MDIFF.
  284.          These libraries will  work ONLY  with *.MDF files  produced by  a
  285.          REGISTERED copy of MDIFF.
  286.          The distribution packet is complete with a sample  source and all
  287.          the needed documentation.
  288.  
  289.  
  290.  
  291.          12.HOW TO REGISTER
  292.  
  293.          The individual registration key  costs 15,000 Italian  Lire. Site
  294.          licenses available on request. The key is valid for  both Dos and
  295.          OS/2 version of the software. Add  to this cost the  expenses for
  296.          key shipping, that  is 1,000 Lire  for Italy  and 2,000 Lire  for
  297.          other countries. The registration key will  be sent via mail, but
  298.          if explicitly required, it  can be also  sent via FAX,  for Italy
  299.          only.  Moreover I can send  you your key via Internet  e-mail, in
  300.          this case you are not requested to pay the shipping cost.
  301.  
  302.  
  303.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                - 5 -
  304.  
  305.  
  306.  
  307.  
  308.  
  309.          You can  pay  the registration  fee  in any  way  you want  (i.e.
  310.          sending me 11$  U.S. via   mail). Better  way is  using a  postal
  311.          order (in Italy) or an international postal order in Italian Lire
  312.          from outside (check with your local post office),  payable to the
  313.          post office of FIRENZE.  The addressee of  the order must  be the
  314.          following:
  315.  
  316.                                    Maurizio Giunti
  317.                                 Via G.B. Foggini, 24
  318.                                  50142 Firenze (FI)
  319.                                         ITALY
  320.  
  321.          It  is better  to indicate on the  order the name of  the program
  322.          you want  to  register, your name, address  and FAX number  or e-
  323.          mail  address  (where  required).   For  short  notes,   use  the
  324.          appropriate space on  the postal order  (if present), or  at best
  325.          send a e-mail to Maurizio Giunti at:
  326.  
  327.                                Fidonet:   2:332/102.3
  328.  
  329.                           Internet:Giunti@stat.ds.unifi.it
  330.  
  331.  
  332.  
  333.          13.ACKNOWLEDGEMENTS
  334.  
  335.          I'd like to  shortly thanks all  those who  helped me to  develop
  336.          this software and its documentation  and all those who  helped me
  337.          in beta-testing. In alphabetical order:
  338.  
  339.                                    Andrea Baitelli
  340.  
  341.                                     Silvia Borri
  342.  
  343.                                     Filippo Dini
  344.  
  345.                                  Fabrizio Fioravanti
  346.  
  347.                                  Cristiano Guidoccio
  348.  
  349.                                 Giovanni Lopes Pegna
  350.  
  351.                                   Marco Maccaferri
  352.  
  353.                                    Giuseppe Scarpi
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.          MDF V1.xx  (C) 1994/95 Maurizio Giunti                - 6 -
  366.